home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / C64 / A-Monthly Disks / (c)aay.d64 / doc_file edit1.4 < prev    next >
Text File  |  2007-02-04  |  9KB  |  189 lines
  1.    ╫HAT FOLLOWS, IS THE DOCUMENTATION FOR THE PROGRAM ╞╔╠┼ ┼─╔╘╧╥ ╓ERSION 1.4
  2.  
  3.  
  4.  
  5.    ╘HIS PROGRAM HAS BEEN DESIGNED FOR USE WITH THE ├OMMODORE 64 (TM) PERSONAL
  6. COMPUTER. ╔N IT'S DE-COMPILED ┬┴╙╔├ SOURCE VERSION, IT WILL ALSO RUN ON THE 
  7. ├OMMODORE 128 (TM) IN EITHER 40 OR 80 ├OLUMN MODE.
  8.  
  9.    ╔ WROTE THIS PROGRAM FOR MY DEAR FRIEND ╦RISTI. ╔T WAS PREPARED AS A SERIES 
  10. OF "LESSON MODULES" FROM WHICH SHE COULD LEARN A FEW OF THE MANY ROUTINES ╔'VE 
  11. INCLUDED. ╔'M QUITE PLEASED WITH THE FINAL RESULT, AND ╔ HOPE THAT ╦RISTI'S 
  12. INTEREST IN LEARNING CONTINUES.
  13.  
  14.    ╘HIS PROGRAM IS ├OPYRIGHTED! ┴LL RIGHTS TO IT ARE RESERVED! ┘OU ARE FREE TO 
  15. DISTRIBUTE THIS AS YOU'LD LIKE, FOR ╔ AM RELEASING THIS VERSION AS ╞╥┼┼╫┴╥┼. 
  16. ═ODIFY IT AS YOU WISH, BUT ├OPYRIGHT LAWS DICTATE THE INCLUSION OF CREDIT TO 
  17. THE ORIGINAL AUTHOR.
  18.  
  19. úúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúúú
  20.    ╞╔╠┼ ┼─╔╘╧╥ 1.4
  21.    úúúúúúúúúúúúúúú
  22.    ╘╚┼ ═┴╔╬ ═┼╬╒
  23.    úúúúúúúúúúúúú
  24.    ┼NTRY INTO ANY OF THE MAJOR ROUTINES WITHIN THE PROGRAM IS ACCESSED THROUGH 
  25. THE ═AIN ═ENU BY SELECTING THE APPROPRIATE OPTION LABLED 0-9. ╧THER FEATURES 
  26. OF THE ╞╔╠┼ ┼─╔╘╧╥ ARE AVAILABLE BY SELECTING THE APPROPRIATE LETTER OR 
  27. SYMBOL. ╘HE ═AIN ═ENU PROMPT IS DEFAULTED TO THE ─╔╙╦/╨╥╔╬╘ ╙ET ╒P. ╘HIS IS 
  28. EXPLAINED MORE IN DETAIL BELOW. ┴T THE BOTTOM OF THE SCREEN ARE THE CURRENT 
  29. SYSTEM CONFIGURATIONS. ╘HESE MAY BE CHANGED AT ANY TIME THROUGH THE
  30. ─╔╙╦/╨╥╔╬╘ ╙ET ╒P, AND WILL THEN REMAIN IN EFFECT UNTIL YOU AGAIN CHANGE THEM, 
  31. OR YOU RESTART THE PROGRAM OR RESET THE COMPUTER.
  32.  
  33.    0-├╥┼┴╘┼ ┴ ╞╔╠┼
  34.    úúúúúúúúúúúúúúú
  35.    ╘HIS OPTION ALLOWS THE USER TO WRITE A NEW FILE WHICH CAN INCLUDE THE USE 
  36. OF ├OMMODORE ├OLOR AND ╟RAPHIC CONTROL CODES. ╔T IS POSSIBLE TO HIGHLIGHT 
  37. WORDS OR PHRASES BY TYPING THEM IN  ╥EVERSE Æ, OR BY CƒH£ANG₧IüNûG THE COLOR OF
  38. THE TEXT.
  39.  
  40.    ┘OU ARE GIVEN A CHOICE OF LINE LENGTH. ╘HIS SELECTION ACTIVATES THE 
  41. ╫╧╥─-╫╥┴╨ FEATURE OF THE ╞╔╠┼ ┼─╔╘╧╥. ╬OTE THAT SELECTION OF 80 COLUMNS DOES 
  42. ╬╧╘ PROVIDE 80 COLUMN VIEWING ON THE 64, OR 128 (IN 40 COLUMN MODE). ╘HIS 
  43. FEATURE HAS NOTHING TO DO WITH THE VIDEO DISPLAY, BUT WILL INSTEAD, SET THE 
  44. FORMAT OF THE ACTUAL FILE AS IT WOULD APPEAR WHEN PRINTED OUT ON PAPER. ╘HE 80 
  45. COLUMN OPTION IS AVAILABLE TO YOU, JUST DONT EXPECT IT TO GIVE AN 80 COLUMN 
  46. DISPLAY TO THE 64.
  47.  
  48.    ╬EXT, YOU WILL SEE AN ASTERISK "*" APPEAR ON YOUR SCREEN. ╘HIS IS THE TEXT 
  49. ENTRY CURSOR. ╔T WILL IGNORE THE ├╒╥╙╧╥-╒╨ AND ├╒╥╙╧╥-─╧╫╬ KEYS, AND WILL 
  50. TREAT A ├╒╥╙╧╥-╠┼╞╘ OR ╥╔╟╚╘ AS IF IT WERE A ─┼╠┼╘┼ OR ╙╨┴├┼ RESPECTIVELY. ╘HE 
  51. ─┼╠┼╘┼ KEY FUNCTIONS NORMALLY, PROVIDING A DESTRUCTIVE BACK-SPACE. ┘OU CANNOT 
  52. HOWEVER, BACKSPACE TO A PREVIOUS LINE THAT HAS ALREADY BEEN ENTERED. ╧NCE A 
  53. LINE PROGRESSES TO THE POINT WHERE WORD-WRAP OCCURS, THE LINE HAS BEEN ENTERED 
  54. INTO THE BUFFER, AND MUST BE EDITED USING THE ┼─╔╘ ┴ ╠╔╬┼ OPTION AT THE ═AIN 
  55. ═ENU.
  56.  
  57.    1-╠╧┴─ ┴ ╞╔╠┼
  58.    úúúúúúúúúúúúú
  59.    ╘HIS OPTION IS USED TO LOAD A ╙┼╤╒┼╬╘╔┴╠ FILE FROM DISK INTO THE TEXT 
  60. BUFFER. ┘OU ARE ASKED FROM WHICH DRIVE YOU WISH TO LOAD THE FILE. ╘HE PROGRAM 
  61. DEFAULTS TO ─RIVE "┴".
  62.  
  63.    ┘OU MAY ╬╧╘ USE A "╫ILDCARD" ├HARACTER IN THE ╞ILENAME [ * OR ? ]. ╘HIS IS
  64. TO PREVENT ─ISK ┼RRORS WHEN LATER USING THE ╥┼╙┴╓┼/╙AME ╬AME OPTION.
  65.  
  66.  
  67.    2-┼─╔╘ ┴ ╠╔╬┼
  68.    úúúúúúúúúúúúú
  69.    ╘HIS OPTION IS USED TO CORRECT MIS-SPELLINGS, ETC. WITHIN YOUR FILE. ┘OU 
  70. WILL BE ASKED TO GIVE THE ╠INE ╬UMBER OF THE LINE YOU WISH TO EDIT. ╔T IS 
  71. RECCOMENDED THAT BEFORE SELECTING THE ┼─╔╘ OPTION, YOU FIRST ╠╔╙╘ THE FILE TO 
  72. DETERMINE THE NUMBER OF THE LINE YOU WISH TO CHANGE.
  73.  
  74.    ╘HIS OPTION IS INACTIVE AND CAN NOT BE ACCESSED AS LONG AS THE TEXT BUFFER 
  75. IS EMPTY. ╧NCE THE BUFFER CONTAINS ONE LINE OR MORE OF TEXT, EITHER LOADED 
  76. FROM DISK OR TYPED IN, THIS OPTION BECOMES AVAILABLE FOR YOU TO USE. ╘HIS SAME 
  77. FEATURE APPLIES TO THESE OTHER ═AIN ═ENU OPTIONS: 3-╔NSERT, 4-─ELETE, 5-╠IST, 
  78. 6-─ISPLAY, 7-╨RINT, 8-╙AVE, AND 9-╥ESAVE. ╬ONE OF THESE ARE AVAILABLE AS LONG 
  79. AS THE BUFFER IS EMPTY.
  80.  
  81.    3-╔╬╙┼╥╘/├╧╬╘╔╬╒┼
  82.    úúúúúúúúúúúúúúúúú
  83.    ╧NCE YOU HAVE ENTERED OR LOADED TEXT INTO THE TEXT BUFFER, YOU MAY SELECT 
  84. THIS FEATURE TO INSERT NEW LINES AT ANY POINT WITHIN YOUR FILE. ┘OU MAY ALSO 
  85. ELECT THE OPTION TO ├╧╬╘╔╬╒┼ ADDING TO A FILE ALREADY IN THE BUFFER, BY 
  86. ENTERING AN ASTERISK "*" WHEN PROMPTED.
  87.  
  88.    4-─┼╠┼╘┼ ┴ ╠╔╬┼
  89.    úúúúúúúúúúúúúúú
  90.    ┘OU MAY DELETE ANY LINE WITHIN YOUR FILE USING THIS OPTION. ┘OU WILL BE 
  91. ASKED FOR THE ╠INE ╬UMBER OF THE LINE YOU WISH TO DELETE. ╘HE PROGRAM WILL 
  92. THEN DISPLAY THAT LINE ON YOUR SCREEN, AND WILL ASK YOU IF YOU ARE SURE YOU 
  93. WISH TO DELETE THE LINE OR ABORT BACK TO THE ═AIN ═ENU, LEAVING THE LINE OF 
  94. TEXT INTACT.
  95.  
  96.    5-╠╔╙╘ ╫/ ╠╔╬┼ #'╙
  97.    úúúúúúúúúúúúúúúúúú
  98.    ╙ELECT THIS OPTION ANY TIME YOU NEED TO DETERMINE THE ╠INE ╬UMBER OF A LINE 
  99. FOR THE PURPOSE OF EDITING, DELETING, ETC. ╘HE FILE WILL SCROLL BY, DISPLAYING 
  100. THE NUMBER FOR EACH LINE. ┘OU MAY PAUSE THE SCROLLING BY PRESSING THE ╙╨┴├┼ 
  101. BAR. ┴NY OTHER KEY WILL CONTINUE THE SCROLL. ╨RESSING THE "┴" AT ANY POINT
  102. DURING THE SCROLL WILL ALLOW YOU TO ABORT BACK TO THE ═AIN ═ENU.
  103.  
  104.    6-─╔╙╨╠┴┘ ╫/╧ #'╙
  105.    úúúúúúúúúúúúúúúúú
  106.    ╘HIS OPTION FUNCTIONS EXACTLY LIKE THE ╠╔╙╘ FUNCTION, EXCEPT FOR ABSENSE
  107. OF ╠INE ╬UMBERS. ╒SE THIS FEATURE TO "╨REVIEW" YOUR TEXT BEFORE SAVING OR 
  108. PRINTING. ╙╨┴├┼ PAUSES THE SCROLL, THE "┴" WILL ABORT.
  109.  
  110.    7-╨╥╔╬╘ ┴ ╚┴╥─ ├╧╨┘
  111.    úúúúúúúúúúúúúúúúúúú
  112.    ╔F YOU HAVE A PRINTER, YOU MAY USE THIS OPTION TO DUMP YOUR TEXT FILE TO 
  113. THE PRINTER. ┬┼ ├┼╥╘┴╔╬ TO SET THE ─╔╙╦/╨╥╔╬╘ DEFAULTS TO SUIT YOU PARTICULAR 
  114. PRINTER. ┴LL ├OMMODORE PRINTERS USE ╙ECONDARY ┴DDRESS 7 TO PLACE THE PRINTER 
  115. IN ╒PPER/╠OWER CASE MODE. ═OST ARE SET TO ─EVICE 4. ╔F THESE SETTINGS DONT 
  116. WORK FOR YOU, CONSULT YOUR PRINTER'S MANUAL, OR EXPERIMENT WITH DIFFERENT 
  117. SETTINGS.
  118.  
  119.    8-╙┴╓┼ ┴ ╬┼╫ ╞╔╠┼
  120.    úúúúúúúúúúúúúúúúú
  121.    ╘HIS SELECTION ALLOWS YOU TO ╙┴╓┼ TO DISK, ANY TEXT CONTAINED WITHIN THE 
  122. BUFFER. ┘OU ARE ASKED WHICH DRIVE YOU WISH TO ╙┴╓┼ TO. ╘HE PROGRAM DEFAULTS TO 
  123. ─RIVE "┴".
  124.  
  125.    9-╥┼╙┴╓┼/╙┴═┼ ╬┴═┼
  126.    úúúúúúúúúúúúúúúúúú
  127.    ╘HIS OPTION IS AVAILABLE SHOULD YOU WISH TO SAVE AN UPDATED VERSION OF THE 
  128. FILE USING THE SAME NAME THE OLD VERSION WAS GIVEN. ╘HIS PROGRAM DOES ╬╧╘ USE 
  129. THE ╙┴╓┼ @ COMMAND. ╘HIS PROGRAM WILL INSTEAD ╙├╥┴╘├╚ THE OLD VERSION, AND 
  130. THEN ╙┴╓┼ THE NEW ONE USING THE OLD NAME. ┴N OPTION TO AVOID SCRATCHING THE 
  131. OLD VERSION IS AVAILABLE BY SIMPLY ENTERING A NAME DIFFERENT FROM THE ORIGINAL 
  132. NAME, JUST AS IF YOU HAD SELECTED THE ╙┴╓┼ FUNCTION AT THE ═AIN ═ENU.
  133.  
  134.    #-─╔╙╦/╨╥╔╬╘ ╙┼╘ ╒╨
  135.    úúúúúúúúúúúúúúúúúúú
  136.    ╚ERE IS WHERE YOU CONFIGURE THE PROGRAM DEFAULTS TO MEET YOUR PARTICULAR 
  137. EQUIPMENT REQUIREMENTS. ╘HIS OPTION IS THE DEFAULT SELECTION AT THE ═AIN ═ENU, 
  138. AND GETTING HERE IS AS EASY AS HITTING ╥┼╘╒╥╬. ╧NCE YOU HAVE FIXED THE 
  139. SETTINGS TO SUIT YOUR EQUIPMENT, THEY WILL REMAIN IN EFFECT UNTIL RESET, ABORT 
  140. TO ┬┴╙╔├, RESTART OF PROGRAM, OR POWER-DOWN.
  141.  
  142.    $-─╔╥┼├╘╧╥┘ ╥┼┴─
  143.    úúúúúúúúúúúúúúúú
  144.    ╙ELECTING THIS OPTION WILL ALLOW YOU TO DISPLAY THE DIRECTORY OF ANY DISK 
  145. IN EITHER DRIVE. ╘HE DEFAULT IS ─RIVE "┴", THOUGH YOU MAY SELECT EITHER DRIVE.
  146.  
  147.    @-─╧╙ ├╧══┴╬─╙
  148.    úúúúúúúúúúúúúú
  149.    ╚ERE YOU WILL FIND ALL THE OPERATIONS YOU NEED TO DO GENERAL HOUSE-CLEANING 
  150. TASKS TO YOUR DISKETTES. 1571 USERS MAY ENTER ╒0>═1 AT THE ─╧╙ OPTION TO PLACE 
  151. THEIR DRIVE IN DOUBLE-SIDED MODE TO ACCESS FILES ON THE BACK SIDE OF THE DISK. 
  152. ╬┼╓┼╥ VALIDATE A DOUBLE-SIDED DISK WHILE THE DRIVE IS IN SINGLE-SIDED MODE. 
  153. ╘HIS WILL RE-WRITE THE DISK ┬┴═ IN SUCH A WAY THAT BACK-SIDE FILES WILL NOT BE 
  154. RECOGNIZED BY THE DRIVE, EVEN IF YOU GO TO DOUBLE-SIDED MODE AFTER VALIDATION 
  155. IN SINGLE-SIDED MODE.
  156.  
  157.    ╙-╙┼╤ ╞╔╠┼ ╥┼┴─┼╥
  158.    úúúúúúúúúúúúúúúúú
  159.    ╒SE THIS OPTION TO "╥EAD" ANY SEQUENTIAL FILE ON DISK, WITHOUT ACTUALLY 
  160. HAVING TO LOAD IT INTO THE BUFFER. ╒SE THE ├╧╬╘╥╧╠ KEY TO SLOW THE LISTING.
  161. ╘HIS OPTION WILL ALSO READ "╓┼" FILES WHICH DONT INCLUDE CARRIAGE RETURNS!
  162.  
  163.    ╥-╥┼╙╘┴╥╘ ╨╥╧╟╥┴═
  164.    úúúúúúúúúúúúúúúúú
  165.    ╘HIS OPTION DOES EXACTLY THAT- RESTARTS THE PROGRAM JUST AS IF YOU HAD JUST 
  166. LOADED IT FROM DISK AND TYPED ╥╒╬. ┴LL SYSTEM DEFAULTS ARE RESET. ┘OU ARE 
  167. PROMPTED THAT ANY TEXT IN THE BUFFER WILL BE LOST, AND YOU ARE GIVEN A CHANCE 
  168. TO ABORT BACK TO THE ═AIN ═ENU.
  169.  
  170.    ┴-┴┬╧╥╘ ╘╧ ┬┴╙╔├
  171.    úúúúúúúúúúúúúúúú
  172.    ╘HE ┴┬╧╥╘ OPTION ALLOWS YOU TO EXIT THE PROGRAM AND RETURN TO ┬┴╙╔├. ╘HIS 
  173. FUNCTION, LIKE THE ╥┼╙╘┴╥╘ DESCRIBED ABOVE, WILL REMIND YOU THAT YOU COULD 
  174. LOSE ANY TEXT YOU HAVE NOT YET SAVED, AND WILL ALLOW YOU TO ABORT BACK TO THE 
  175. ═AIN ═ENU.
  176. ----------------------------------------------------------------------------
  177.  
  178. ╘HERE ARE TWO VERSIONS OF 1.4 AVAILABLE.. ╧NE HAS BEEN COMPILED FOR THE ├64, 
  179. THE OTHER FOR THE 128.  ╘HE 64 VERSION REQUIRES NOT ONLY THE MAIN FILE, BUT A 
  180. SHORT BOOT FILE, AND AN M/L ROUTINE.  ┴LL TOGETHER, THE ├64 REQUIRES THE 
  181. FOLLOWING:  ├64/╞╔╠┼ ┼─╔╘1.4 (THE MAIN FILE), ├64/┼─╔╘1.4 ┬╧╧╘ (THE BOOT),
  182. AND ├64/╞╔╠┼ ┼─╔╘.═╠ (THE MACHINE LANGUAGE ROUTINE).  ╘HE BOOT FILE IS LOADED 
  183. USING ,8. 
  184.  
  185.  ╘HE 128 VERSION INCLUDES ONLY THE MAIN FILE (COMPILED FOR THE 128) 128/╞╔╠┼ ┼─╔╘1.4
  186.  
  187.  
  188.  ─OCUMENTATION FOR EITHER VERSION IS THE SAME... ─╧├/╞╔╠┼ ┼─╔╘1.4
  189.